package org.jeecg.modules.crm.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import org.jeecg.modules.crm.entity.CrmCustomer;
import org.jeecg.modules.crm.entity.vo.CrmCustomerVO;

import java.util.List;
import java.util.Map;

/**
 * @Description: 客户信息表
 * @Author: jeecg-boot
 * @Date:   2025-06-03
 * @Version: V1.0
 */
public interface ICrmCustomerService extends IService<CrmCustomer> {
    
    /**
     * 保存客户信息和相关联系人、项目
     * @param customerVO 客户VO对象
     * @return 是否保存成功
     */
    boolean saveCustomerVO(CrmCustomerVO customerVO);
    
    /**
     * 更新客户信息和相关联系人、项目
     * @param customerVO 客户VO对象
     * @return 是否更新成功
     */
    boolean updateCustomerVO(CrmCustomerVO customerVO);
    
    /**
     * 根据ID获取客户完整信息（包含联系人和项目）
     * @param id 客户ID
     * @return 客户VO对象
     */
    CrmCustomerVO getCustomerVOById(String id);
    
    /**
     * 分页查询客户列表
     * @param page 分页参数
     * @param customer 查询条件
     * @return 分页数据
     */
    IPage<CrmCustomer> selectCustomerPage(Page<CrmCustomer> page, CrmCustomer customer);
    
    /**
     * 删除客户及关联数据
     * @param id 客户ID
     * @return 删除结果
     */
    boolean deleteCustomerById(String id);
    
    /**
     * 根据关键字获取客户智能提示列表
     * @param keyword 关键字
     * @param limit 限制条数
     * @return 客户列表
     */
    List<CrmCustomer> getSuggestCustomerList(String keyword, Integer limit);
    
    /**
     * 根据关键字获取联系人智能提示列表
     * @param keyword 关键字
     * @param limit 限制条数
     * @return 联系人列表
     */
    List<Map<String, Object>> getSuggestContactList(String keyword, Integer limit);
    
    /**
     * 检查客户信息相似度
     * @param customerVO 客户信息
     * @return 相似度列表
     */
    List<Map<String, Object>> checkCustomerSimilarity(CrmCustomerVO customerVO);
} 